PXC Documentation

PXC Home

3D Instancer

pre 1.18

Node Data

Display name

3D Instancer

Internal name

Node_3D_Instancer

Inheritances

Node_3D
Node_3D_Instancer

Inputs

Object

d3mesh

Mesh

Transform

vec3

Starting Position

quat

Starting Rotation

vec3

Starting Scale

Repeat

enum

Pattern

int

Amounts

ivec3

Grid

float

Radius

bool

Look At Center

Path

path

Shift Path

range

Path Range

bool

Follow Path

Transform Data

vec3

Positions

vec3

Rotations

vec3

Scales

vec3

Normals

Shift

vec3

Shift Position

vec3

Shift Position Y

vec3

Shift Position Z

quat

Shift Rotation

vec3

Shift Scale

Scatter

range3

Position Scatter

range3

Rotation Scatter

range3

Scale Scatter

bool

Scale Uniform

Render

palette

Colors Per Index

gradient

Random Colors

Outputs

d3mesh

Mesh

Create multiple copies of a 3D model using instancing.



Properties


Object
MeshBase model
Repeat
PatternInstancing pattern.
AmountsInstance count for Linear and Circular patterns.
GridGrid subdivision in Grid pattern.
RadiusCircular pattern radius.
Look At CenterRotate instances toward center point.
Path
PathPlaces instances along path.
Follow PathRotate instances along path.
Transform Data (Apply direct array of data to transform each instance directly.)
PositionsArray of vec3s for position.
RotationsArray of quaternions for rotation.
ScalesArray of vec3s for scale.
NormalsArray of vec3s for normal.
Shift (Transform each instance accumulatively)
Shift PositionShift each new instance for Linear and Circular patterns.
Shift Position YShifting amount for Y axis in Grid pattern.
Shift Position ZShifting amount for Z axis in Grid pattern.
Shift RotationRotate each new instance by a fix amount.
Shift ScaleScale each new instance by a fix amount.
Scatter (Transform each instance randomly)
Position ScatterRandom shift in position.
Rotation ScatterRandom shift in rotation.
Scale ScatterRandom shift in scale.
Scale UniformApply the same scale factor to all axes.
Render
Colors Per IndexApply color blending by order.
Random ColorsApply random color sampled from a gradient.



Instancing vs. Repeat


This node is similiar to 3D Repeat. The main different is this node use instancing to create a clone while 3D Repeat create multiple objects.


Instancing Repeat
Faster for large amount of copies. Slower but no extra compile time.
Less flexible (cannot used with Scene Affector). More flexible.


Commit History


1.19.7.1
  • Introduced
1.21.rc7
  • Fix grid allows floating value.
1.21.6.001
  • Fix memory leak on rendering.


Related Links